@smithy/middleware-retry

Standard Retry Strategy

The StandardRetryStrategy provides a default retry strategy that retries failed requests with exponential backoff and jitter. This is useful for handling transient errors and improving the reliability of your application.

const { StandardRetryStrategy } = require('@smithy/middleware-retry');
const retryStrategy = new StandardRetryStrategy();

// Use the retry strategy in a client configuration
const client = new SomeAWSClient({
  region: 'us-west-2',
  retryStrategy
});

Custom Retry Strategy

You can create a custom retry strategy by extending the RetryStrategy class and implementing your own logic for determining when to retry and how many attempts to make. This allows you to tailor the retry behavior to your specific needs.

const { RetryStrategy } = require('@smithy/middleware-retry');

class CustomRetryStrategy extends RetryStrategy {
  shouldRetry(error) {
    // Custom logic to determine if the request should be retried
    return error.retryable;
  }

  getMaxAttempts() {
    // Custom logic to determine the maximum number of retry attempts
    return 5;
  }
}

const customRetryStrategy = new CustomRetryStrategy();

// Use the custom retry strategy in a client configuration
const client = new SomeAWSClient({
  region: 'us-west-2',
  retryStrategy: customRetryStrategy
});

Adaptive Retry Strategy

The AdaptiveRetryStrategy dynamically adjusts the retry behavior based on the observed success and failure rates of requests. This can help optimize the retry behavior for different network conditions and improve overall performance.

const { AdaptiveRetryStrategy } = require('@smithy/middleware-retry');
const adaptiveRetryStrategy = new AdaptiveRetryStrategy();

// Use the adaptive retry strategy in a client configuration
const client = new SomeAWSClient({
  region: 'us-west-2',
  retryStrategy: adaptiveRetryStrategy
});